4장 화면과 기본 조작 익히기

출처: 클로드 코드 완벽 가이드, 코드팩토리 최지호

이 장에서 딱 5가지만 1. 프로젝트 폴더의 "맨 위층"에서 클로드 코드를 켜는 법 2. 켜면 나오는 화면(웰컴 메시지)을 읽는 법 3. /init 으로 프로젝트 설명서(CLAUDE.md)를 자동으로 만드는 법 4. 자주 쓰는 단축키 몇 개로 빠르게 조작하는 법 5. /ide 로 바뀐 코드를 눈으로 보며 확인하는 법

학습 목표 - 클로드 코드를 어디서 켜야 하는지 설명한다. - 웰컴 메시지의 각 줄이 무슨 뜻인지 구분한다. - /init 을 따라 해서 CLAUDE.md 를 만든다. - 단축키 Ctrl+C 와 Ctrl+D 를 구분한다. - /ide 연동을 따라 한다.

들어가기 전에

3장까지 잘 따라왔다면 컴퓨터에 클로드 코드가 설치되어 있고, 로그인도 끝난 상태다. 설치는 했는데 막상 "그래서 이걸 어떻게 켜고, 켜면 뭘 봐야 하지?" 하고 멍해질 수 있다. 이 장은 바로 그 첫 화면과 기본 조작만 차근차근 익힌다.

여기서 처음 나오는 말 몇 개는 0장 용어집에 정리돼 있다고 보면 된다. 혹시 처음 보는 단어가 있어도, 본문에서 처음 나올 때 한 줄로 뜻을 같이 적어두었다.

이 장을 시작하기 전에 아래가 준비됐는지 가볍게 확인하자. - 3장: 클로드 코드 설치 완료 - 3장: 로그인 완료 - 터미널에서 cd 로 폴더 이동하는 법 (앞 장 참고) - git clone 으로 예제 코드를 내려받는 법

4.1 프로젝트의 "맨 위층"에서 클로드 코드 켜기

이거 이렇게 하다 막힌 적 있죠?

새 프로젝트를 받았다. 신나서 아무 폴더에서나 클로드 코드를 켰다. 그런데 클로드가 엉뚱한 파일만 보거나, 정작 중요한 설정 파일을 못 찾는다.

이건 클로드가 멍청해서가 아니다. 켠 위치가 잘못돼서다.

클로드 코드는 "켠 그 폴더"를 작업 범위로 삼는다. 그래서 프로젝트의 맨 위층(프로젝트 루트)에서 켜야 전체를 다 본다.

프로젝트 루트: 프로젝트의 가장 바깥쪽 폴더. 마치 집의 현관 같은 곳이라, 여기서 들어가야 집 안 모든 방이 보인다.

워킹 디렉터리(cwd): 클로드가 "지금 내가 일하는 폴더"라고 인식한 위치. 켠 폴더가 곧 이 위치가 된다.

비유로 먼저

실제로 해보기

먼저 예제 프로젝트를 내려받고, 그 폴더 안으로 들어간 다음, 거기서 클로드 코드를 켠다.

git clone github.com/codefactory-co/golden-rabbit-yojeum-claude-code-crypto-ranking-board
cd golden-rabbit-yojeum-claude-code-crypto-ranking-board
claude

예제는 Next.js 로 만든 코인 랭킹 대시보드다. 화면으로 직접 보고 싶다면 아래처럼 서버를 켜면 된다.

pnpm install
pnpm dev

그러면 브라우저에서 http://localhost:3000 으로 확인할 수 있다.

여기서 중요한 점이 하나 있다. 서버를 켠 터미널은 그대로 두고, 클로드 코드는 새 터미널을 하나 더 열어서 켠다. 한 터미널에서 둘 다 하려 하면 서로 화면이 섞이거나 서버가 멈춘다.

잘못된 예 vs 올바른 예

# 잘못된 예: 아무 데서나 켜기
cd ~/Desktop
claude
# → 프로젝트와 상관없는 파일까지 보거나 범위를 벗어난다

# 올바른 예: 프로젝트 루트로 들어가서 켜기
cd golden-rabbit-yojeum-claude-code-crypto-ranking-board
claude
# → 이 프로젝트 파일만 정확히 본다

이럴 때 이렇게

상황: src/components/ 같은 깊은 하위 폴더에서 클로드 코드를 켰더니, package.json 같은 설정 파일을 못 찾는다. 이유: 켠 위치(하위 폴더)가 작업 범위가 돼서, 그 위층 파일이 안 보인다. 해결: 1. Ctrl+D 로 일단 종료한다. (Ctrl+D 는 뒤에서 다시 설명한다) 2. cd ../.. 로 프로젝트 루트(맨 위층)로 올라간다. 3. claude 로 다시 켠다. 4. 켜면 나오는 화면에서 cwd 경로가 프로젝트 루트인지 확인한다.

첫 실행에서 한 번 더 — 폴더 신뢰 확인

처음 그 폴더에서 클로드를 켜면 "이 폴더의 파일을 봐도 될까요?" 하고 묻는다. 이건 보안 확인이다. 내 폴더가 맞으면 Yes, proceed 를 고르고 Enter 를 누른다.

폴더 신뢰: 클로드가 이 폴더의 파일을 읽고 고쳐도 되는지 사용자에게 한 번 허락받는 절차. 처음 들어온 손님에게 "들어와도 돼요" 하고 문 열어주는 것과 같다.

4.2 켜면 나오는 화면(웰컴 메시지) 읽기

이거 이렇게 하다 막힌 적 있죠?

클로드 코드를 처음 켜면 화면에 글자가 잔뜩 뜬다. 뭘 봐야 할지 몰라서 그냥 무시하고 넘어간다. 그러다 정작 "내가 지금 어느 폴더에서 작업 중이지?"를 놓친다.

이 첫 화면이 바로 웰컴 메시지다. 사실 여기엔 꼭 봐야 할 정보가 친절하게 적혀 있다.

웰컴 메시지: 클로드 코드를 켜면 처음 나오는 안내 화면. 식당에 들어가면 받는 메뉴판 같은 것이라, 뭘 할 수 있는지 한눈에 알려준다.

비유로 먼저

화면 구조 살펴보기

✱ Welcome to Claude Code!          ← 인사말

/help for help, /status for setup  ← 도움말 안내

cwd: /Users/.../crypto-ranking-board   ← 지금 작업 중인 폴더 (꼭 확인)

Tips for getting started:          ← 시작 팁
1. Run /init to create a CLAUDE.md
2. Use Claude to help with file analysis
3. Be as specific as you would with another engineer
4. Run /terminal-setup

> |                                ← 여기에 내가 입력

여기서 딱 두 줄만 기억하자. 하나는 cwd 줄이다. 지금 어느 폴더에서 일하는지 알려준다. 다른 하나는 맨 아래 > 입력칸이다. 여기에 내가 하고 싶은 말을 적는다.

한 걸음 더 ▸ /status 로 내 상태 한눈에 보기

웰컴 메시지 둘째 줄에 /status for setup 이라고 적혀 있는 거 봤는가. 이 /status 가 바로 "지금 내 클로드 코드가 어떤 상태인지" 한 장으로 보여주는 명령이다. 입력칸에 그냥 /status 라고 치면 된다.

> /status

그러면 지금 어떤 계정으로 로그인했는지, 어떤 모델을 쓰고 있는지, 설정이 어떻게 잡혀 있는지를 쭉 보여준다.

/status: 지금 내 클로드 코드의 로그인 계정·모델·설정 상태를 한눈에 보여주는 슬래시 명령. 병원 가면 먼저 재는 키·몸무게·혈압 같은 기본 검진표라고 보면 된다.

언제 쓰면 좋을까.

뭔가 이상한데 원인을 모르겠으면, 일단 /status 부터 쳐서 기본 상태를 확인하는 습관이 좋다.

자연어로 말 걸어보기

클로드 코드는 터미널에서 돌아가지만, 사용하는 느낌은 챗봇과 똑같다. 명령어 외우지 말고, 그냥 평소 말투로 부탁하면 된다.

> 현재 프로젝트 상태를 파악해봐

이렇게만 적어도 클로드가 프로젝트를 쭉 훑어보고 정리해 준다. 보통 이런 내용을 알려준다. - 프로젝트 개요 (무슨 목적, 어떤 프레임워크) - 구조 (핵심 부품, 시작 지점) - 데이터 구조 - 화면 특징 (반응형, 다크 테마 등) - 사용한 기술과 라이브러리 목록

잘못된 예 vs 올바른 예

# 잘못된 예: 너무 막연함
> 코드 봐줘

# 올바른 예: 무엇을 원하는지 구체적으로
> 현재 프로젝트 상태를 파악해서 구조와 기술 스택을 정리해줘

팁 화면에도 적혀 있듯이, 동료 개발자에게 부탁하듯 구체적으로 말할수록 결과가 좋다.

이럴 때 이렇게

상황: 분명 작업을 시켰는데 클로드가 엉뚱한 파일을 본다. 확인: 웰컴 메시지의 cwd 줄을 본다. 원인: cwd 가 내가 원하는 프로젝트가 아니다. 해결: Ctrl+D 로 끄고, 맞는 폴더로 cd 한 뒤 다시 claude.

4.3 /init 으로 프로젝트 설명서(CLAUDE.md) 만들기

이거 이렇게 하다 막힌 적 있죠?

매번 작업을 시킬 때마다 "이 프로젝트는 pnpm 을 써", "TypeScript 야" 하고 처음부터 설명해야 한다면 번거롭다. 클로드가 매번 처음 온 사람처럼 군다면 일이 더디다.

그래서 프로젝트 안내서를 한 번 만들어두면 좋다. 그 안내서가 CLAUDE.md 파일이고, 이걸 자동으로 만들어주는 게 /init 명령이다.

슬래시 명령어: / 로 시작하는 특수 명령. 게임에서 단축키를 입력하듯, 자주 쓰는 기능을 빠르게 부를 때 쓴다. (/init, /help, /ide 등)

CLAUDE.md: 프로젝트의 구조·기술·규칙을 한 장에 정리한 파일. 클로드가 매번 읽는 "프로젝트 안내서"다.

비유로 먼저

실제로 해보기

입력칸에 슬래시 명령을 적는다.

> /init

그러면 클로드가 프로젝트를 분석한 뒤, 어떤 내용으로 안내서를 만들지 계획을 먼저 보여준다. 대략 이런 항목들이 들어간다.

CLAUDE.md 생성 계획
1. 프로젝트 개요
2. 개발 명령어 (빌드/테스트)
3. 아키텍처 구조
4. 기술적 결정사항
5. 컴포넌트 구성
6. 중요 참고사항
7. 일반적인 작업 안내

그다음 "이 파일 만들까요?" 하고 묻는다. 선택지가 세 개 나온다.

Do you want to make this edit to CLAUDE.md?

> 1. Yes                              ← 보통 이걸 고른다
  2. Yes, and don't ask again         ← 이번 세션은 더 안 묻고 자동 승인
  3. No, and tell Claude ...          ← 다르게 해달라고 다시 부탁

기본은 1번 Yes 다. 1번을 고르고 Enter 를 누르면 프로젝트 루트에 CLAUDE.md 파일이 생긴다.

코인 랭킹 보드 예제라면 안내서에 이런 내용이 담긴다.

(여기 적힌 버전 번호나 기술 이름은 원서/노트 기준 예시이며, 최신 값은 공식 문서(클로드 코드 공식 문서)에서 확인하면 된다.)

한 걸음 더 ▸ 영어로 만들어졌을 때

/init 이 만든 CLAUDE.md 가 영어로 나올 때가 있다. 그럴 땐 그냥 말로 부탁하면 된다.

> CLAUDE.md를 한글로 변경해줘

클로드가 파일을 읽고 한글로 바꾼 버전을 제안한다. Yes 를 고르면 반영된다.

잘못된 예 vs 올바른 예

# 잘못된 예: /init 을 매번 다시 실행
> /init   (어제도 했는데 오늘 또)
# → 기존 안내서를 다시 만들 수 있다. 한 번이면 충분

# 올바른 예: 한 번만 만들고, 이후엔 수정 요청
> CLAUDE.md에 "테스트는 pnpm test로 실행" 규칙 추가해줘

이럴 때 이렇게

상황: 입력칸에서 / 만 눌렀더니 명령 목록이 좌르륵 뜬다. 이건 정상이다. / 를 누르면 쓸 수 있는 슬래시 명령들이 자동완성으로 보인다. 거기서 원하는 걸 골라도 되고, 글자를 더 쳐서 좁혀도 된다.

4.4 자주 쓰는 단축키 익히기

이거 이렇게 하다 막힌 적 있죠?

클로드가 답변을 너무 길게 쏟아낸다. 멈추고 싶은데 방법을 몰라 끝날 때까지 기다린다. 혹은 줄을 바꾸려고 Enter 를 눌렀는데 메시지가 그냥 전송돼 버린다.

이런 답답함은 단축키 몇 개만 알면 사라진다. 단축키는 게임 컨트롤러 버튼 같은 거라, 손에 익으면 메뉴를 안 열고도 빠르게 조작한다.

비유로 먼저

단축키 정리

세션 제어

Ctrl + C   지금 입력이나 생성 중인 답변을 중단
Ctrl + D   클로드 코드 세션을 완전히 종료
Ctrl + L   입력칸을 싹 비움 (대화 기록은 유지)

이전 것 다시 꺼내기 / 되돌리기

위/아래 방향키   이전에 보낸 메시지를 순서대로 다시 꺼냄
Esc Esc          직전 메시지 상태로 되돌림 (다른 길로 다시 시도)

대화 포크: Esc 를 두 번 눌러 이전 시점으로 돌아가 다른 방향으로 다시 대화하는 것. 갈림길에서 한 발 물러나 다른 길을 골라보는 셈이다.

줄바꿈(메시지 안에서 줄 바꾸기)

\ + Enter        모든 터미널에서 되는 가장 안전한 방법
Option + Enter   맥의 기본 설정에서
Shift + Enter    /terminal-setup 을 한 번 실행한 뒤에 사용

빠른 접두사

# 메시지       CLAUDE.md 에 메모를 빠르게 추가 (포스트잇 붙이기)
/ 명령어       슬래시 명령 실행

잘못된 예 vs 올바른 예

# 잘못된 예: 세션을 끄려고 Ctrl+C
Ctrl + C
# → 이건 "중단"일 뿐, 세션은 그대로 살아 있다

# 올바른 예: 종료는 Ctrl+D
Ctrl + D

# 잘못된 예: 줄바꿈하려고 그냥 Enter
첫째 줄 [Enter]
# → 메시지가 바로 전송됨

# 올바른 예: \ + Enter 로 줄을 바꾼다
첫째 줄 \ + Enter
둘째 줄 \ + Enter
셋째 줄 Enter   (여기서 전송)

이럴 때 이렇게 — 상황별

상황 1: 클로드가 답변을 너무 길게 한다. → Ctrl+C 로 멈추고 "더 간결하게 답변해줘" 하고 다시 요청.

상황 2: 프롬프트를 잘못 보냈다. → Esc 두 번으로 직전 상태로 돌아가 다시 입력.

상황 3: 여러 줄짜리 긴 요청을 쓰고 싶다. → 각 줄 끝에 \ + Enter, 마지막 줄에서만 Enter.

상황 4: 어제 잘 먹혔던 요청을 다시 쓰고 싶다. → 위 방향키로 그 메시지를 찾고 Enter.

한 걸음 더 ▸ # 메모 단축키

대화로 일일이 "이거 기억해둬" 하지 않아도 된다. 입력칸에 # 으로 시작해 적으면 그 내용이 CLAUDE.md 에 바로 메모로 들어간다.

> # 테스트 실행 시 반드시 pnpm test 를 사용할 것

정교하게 고치고 싶으면 대화로 부탁하고, 짧게 메모만 남길 땐 # 을 쓰면 편하다.

4.5 /ide 로 바뀐 코드 눈으로 확인하기

이거 이렇게 하다 막힌 적 있죠?

클로드가 코드를 잔뜩 고쳤다. 터미널에 변경 내용이 길게 쏟아진다. 어디가 어떻게 바뀐 건지 눈으로 따라가기가 힘들다. 그러다 중요한 변경을 놓친다.

터미널 글자만으로 변경을 파악하는 건, 전화로 그림 설명을 듣는 것과 비슷하다. 직접 눈으로 보면 훨씬 쉽다. 그 "눈으로 보기"를 켜주는 게 /ide 연동이다.

IDE 연동: /ide 명령으로 클로드의 코드 변경을 VSCode 같은 편집기 화면에서 보게 하는 기능. 바뀐 부분을 색으로 보여준다.

diff 뷰: 바뀌기 전과 후를 나란히 비교해 보여주는 화면. 지운 줄은 빨간색, 더한 줄은 초록색으로 칠해진다.

비유로 먼저

실제로 해보기

입력칸에서 슬래시 명령을 친다.

> /ide

그다음 흐름은 이렇다. 1. 클로드가 코드 변경을 제안한다. 2. Yes 를 고른다. 3. IDE 화면에 변경 전/후가 diff 뷰로 뜬다. 지운 줄은 빨강, 더한 줄은 초록. 4. IDE 의 Apply 버튼으로 변경을 반영한다.

잘못된 예 vs 올바른 예

잘못된 예: 변경이 많은데 터미널 글자만 보고 대충 넘김
→ 어디가 바뀌었는지 모른 채 Yes
→ 실수로 중요한 변경을 놓침

올바른 예: /ide 로 diff 를 켜고 색으로 확인 후 반영
→ 빨강·초록으로 한눈에 보고 Apply

이럴 때 이렇게

상황: 변경 줄이 몇 줄 안 된다. → 굳이 IDE 연동 안 해도 터미널로 충분하다. /ide 는 선택 사항이다.

상황: 한 번에 여러 파일을 크게 고친다. → /ide 를 켜서 눈으로 확인하는 게 안전하다.

참고로 /ide 는 VSCode, IntelliJ IDEA 같은 주요 편집기에서 쓸 수 있다.

한눈에 정리

첫 실행 순서 (네 단계)

1. cd 프로젝트폴더       프로젝트 루트(맨 위층)로 이동
2. claude                클로드 코드 실행
3. Yes, proceed          폴더 신뢰 확인
4. /init → Yes           CLAUDE.md 자동 생성

단축키 한 장 요약

잘못된 방식 vs 올바른 방식

잘못된 방식
1. 하위 폴더(src/components/)에서 켜기 → 설정 파일을 못 봄
2. 서버 켠 터미널에서 그대로 클로드 켜기 → 화면이 섞임
3. Ctrl+C 로 세션을 끄려 함 → 중단일 뿐, 안 꺼짐
4. Enter 로 줄바꿈 → 그냥 전송됨

올바른 방식
1. 프로젝트 루트(맨 위층)에서 켜기
2. 새 터미널을 열어 따로 켜기
3. 종료는 Ctrl+D
4. 줄바꿈은 \ + Enter

클로드 코드 화면, 다른 도구와 뭐가 다를까

스스로 점검하기

1. 프로젝트를 분석하려면 어느 폴더에서 claude 를 켜야 하나? 답: 프로젝트 루트(맨 위층). 하위 폴더에서 켜면 위층 설정 파일을 못 본다.

2. 줄바꿈하는 가장 안전한 방법은? 답: \ + Enter. 운영체제나 터미널 상관없이 되고, 설정도 필요 없다.

3. 세션을 끄려면 Ctrl+C 와 Ctrl+D 중 무엇? 답: Ctrl+D. Ctrl+C 는 중단일 뿐 세션은 살아 있다.

4. 영어로 만들어진 CLAUDE.md 를 한글로 바꾸려면? 답: "CLAUDE.md 를 한글로 변경해줘" 하고 말로 부탁하면 된다.

다음 장 예고

다음 장에서는 슬래시 명령어를 더 폭넓게 다룬다. 지금은 /init, /ide 만 알아도 충분하니 몰라도 된다.